home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3s / fsetpos.z / fsetpos
Encoding:
Text File  |  2002-10-03  |  3.6 KB  |  67 lines
  1.  
  2.  
  3.  
  4. FFFFSSSSEEEETTTTPPPPOOOOSSSS((((3333SSSS))))                                                        FFFFSSSSEEEETTTTPPPPOOOOSSSS((((3333SSSS))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      fsetpos, fsetpos64, fgetpos, fgetpos64 - reposition a file pointer in a
  10.      stream
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssttttddddiiiioooo....hhhh>>>>
  14.  
  15.      iiiinnnntttt ffffsssseeeettttppppoooossss ((((FFFFIIIILLLLEEEE ****ssssttttrrrreeeeaaaammmm,,,, ccccoooonnnnsssstttt ffffppppoooossss____tttt ****ppppoooossss))));;;;
  16.  
  17.      iiiinnnntttt ffffsssseeeettttppppoooossss66664444 ((((FFFFIIIILLLLEEEE ****ssssttttrrrreeeeaaaammmm,,,, ccccoooonnnnsssstttt ffffppppoooossss66664444____tttt ****ppppoooossss))));;;;
  18.  
  19.      iiiinnnntttt ffffggggeeeettttppppoooossss ((((FFFFIIIILLLLEEEE ****ssssttttrrrreeeeaaaammmm,,,, ffffppppoooossss____tttt ****ppppoooossss))));;;;
  20.  
  21.      iiiinnnntttt ffffggggeeeettttppppoooossss66664444 ((((FFFFIIIILLLLEEEE ****ssssttttrrrreeeeaaaammmm,,,, ffffppppoooossss66664444____tttt ****ppppoooossss))));;;;
  22.  
  23. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  24.      _F_s_e_t_p_o_s and _f_g_e_t_p_o_s save and restore the file position indicated by the
  25.      value of the object pointed at by _p_o_s.
  26.  
  27.      The functions _f_s_e_t_p_o_s_6_4 and _f_g_e_t_p_o_s_6_4 are identical to _f_s_e_t_p_o_s and
  28.      _f_g_e_t_p_o_s respectively, except that they take an _f_p_o_s_6_4__t * as an argument.
  29.      This allows for the specification of a file position that is greater that
  30.      2 Gigabytes.
  31.  
  32.      A call to _f_g_e_t_p_o_s stores the current value of the file position indicator
  33.      for _s_t_r_e_a_m in the object pointed at by _p_o_s.  The information is encoded
  34.      in a format which may only be usable by _f_s_e_t_p_o_s for the repositioning the
  35.      _s_t_r_e_a_m to its position at the time of the call to _f_g_e_t_p_o_s.
  36.  
  37.      _F_s_e_t_p_o_s restores the file position of the _s_t_r_e_a_m to the value encoded in
  38.      the object pointed at by _p_o_s, which must have been set by a previous call
  39.      to _f_g_e_t_p_o_s on the same stream.  A successful call to _f_s_e_t_p_o_s clears the
  40.      end-of-file indicator for the stream and undoes any effect of the
  41.      _u_n_g_e_t_c(3S) function on it.  After a call to _f_s_e_t_p_o_s, the next operation
  42.      on an update stream may be either input or output.
  43.  
  44. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  45.      lseek(2), fseek(3s), fopen(3S), popen(3S), stdio(3S), ungetc(3S).
  46.  
  47. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  48.      If successful, both _f_s_e_t_p_o_s and _f_g_e_t_p_o_s return zero.  On failure, they
  49.      return non-zero and set eeeerrrrrrrrnnnnoooo to indicate the error.
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.